Skip to main content

更改输出数据响应

变更场景

某些对触发器、操作或搜索的输出数据结构的更改可能对用户造成破坏性变更。即使输出字段的键保持不变,如果一个或多个字段返回的数据结构或格式发生重大变化,也会影响用户的 Zap。

潜在破坏性更改场景的示例:

  • 一个表示日期时间的输出字段从完整日期格式(例如,'星期四,四月 10, 2023 6:30:00 AM')更新为 ISO-8601 格式
  • 一个搜索中的 results 字段现在返回所有搜索结果,而不是单个最近创建的结果
  • 一个先前用逗号分隔的列表值被改为返回行项目

对用户的影响

您集成步骤中更新的输出字段可能会影响后续操作在用户 Zap 中的运行方式,尤其是当这些字段被映射到后续操作的输入字段时。

例如,如果用户设置了一个 Formatter 步骤来从 added_date 字段解析出星期几并将其添加到 CRM 中,将日期格式改为 ISO-8601 可能会导致 Formatter 处理意外的值,从而在用户的 Zap 中引发问题。

另一个示例是,用户 Zap 中的搜索配置始终基于 results 字段中的最新创建日期返回单个结果。如果搜索被更新为返回所有结果,后续操作可能无法处理多个结果,从而导致潜在问题。

最佳实践